<html><head><title>DragPrivate</title></head>
<body bgcolor="#FFFFDF" link="#009999" vlink="#006666" alink="#006666">
<font face="Arial" size="2"><p align="center"><b><font size="4">DragPrivate()</font></b></p>
<p><b>Syntax</b></p><blockquote>
Result = <font color="#006666"><b>DragPrivate</b></font>(Type [, Actions])</blockquote>

</blockquote>
<b>Description</b><br><blockquote>

Starts a "private" Drag & Drop operation. Unlike the other functions that start Drag & Drop, this data can 
only be dropped inside the application (Data dragged with functions like <a href="dragtext.html">DragText()</a> or 
<a href="dragimage.html">DragImage()</a> can be accepted by other applications as well). This function should be used 
to add Drag & Drop functionality between <a href="../gadget/index.html">Gadgets</a> or <a href="../window/index.html">Windows</a> with 
data that would not be understood by other applications. 

</blockquote><p><b>Parameters</b></p><blockquote>
<style type="text/css">
table.parameters { border-spacing: 0px; border-style: none; border-collapse: collapse; }
table.parameters td { border-width: 1px; padding: 6px; border-style: solid; border-color: gray; vertical-align: top; font-family:Arial; font-size:10pt; }
</style>
<table width="90%" class="parameters">
<tr><td width="10%"><i>Type</i></td>
<td width="90%"> 
This parameter can be any integer value that identifies the data to be dragged in the application. The same value must be 
specified for <a href="enablegadgetdrop.html">EnableGadgetDrop()</a> or <a href="enablewindowdrop.html">EnableWindowDrop()</a> 
for those <a href="../gadget/index.html">Gadget</a>/<a href="../window/index.html">Windows</a> that should accept this data. 
<br>
This way it can be exactly defined which private drag operation will be accepted by Gadget/Window, 
which allows complex Drag & Drop schemes to be realized. 

</td></tr>
<tr><td><i>Actions (optional)</i></td>
<td> 
A combination of the Drag & Drop actions that should be allowed for the data. 
If the parameter is not specified, <font color="#924B72">#PB_Drag_Copy</font> will be the only allowed action. 
Possible actions are: (they can be combined with '|') 
<pre><font face="Courier New, Courier, mono"size="2">  <font color="#924B72">#PB_Drag_Copy</font>: The data can be copied
  <font color="#924B72">#PB_Drag_Move</font>: The data can be moved
  <font color="#924B72">#PB_Drag_Link</font>: The data can be linked
</font></pre>

The user can decide which of these actions to take by pressing modifier keys like Ctrl or Shift. The actions 
that can really be taken also depend on the actions allowed by the drop target. 

</td></tr>
</table>
</blockquote><p><b>Return value</b></p><blockquote>

Returns one of the above Drag & Drop action values to indicate what action the user took, or 
<font color="#924B72">#PB_Drag_None</font> if the user aborted the Drag & Drop operation. 

</blockquote><p><b>Remarks</b></p><blockquote>

Drag & Drop can basically be started any time, but the 
left mouse button should be currently pressed as otherwise the operation will end immediately without success. 
The usual time to start a Drag & Drop operation is when a <a href="../gadget/index.html">Gadget</a> reported an event with 
<a href="../window/eventtype.html">EventType()</a> of <font color="#924B72">#PB_EventType_DragStart</font>. 
<br>
<br>
If the operation was not aborted, the <a href="../window/waitwindowevent.html">event loop</a> will receive a <font color="#924B72">#PB_Event_WindowDrop</font> or 
<font color="#924B72">#PB_Event_GadgetDrop</font> event of type <font color="#924B72">#PB_Drop_Private</font>. 

</blockquote><p><b>See Also</b></p><blockquote>

<a href="dragtext.html">DragText()</a>, <a href="dragimage.html">DragImage()</a>, <a href="dragfiles.html">DragFiles()</a>, <a href="dragosformats.html">DragOSFormats()</a>, 
<a href="setdragcallback.html">SetDragCallback()</a> 

</Blockquote><p><b>Supported OS </b><Blockquote>All</Blockquote></p><center><- <a href=dragosformats.html>DragOSFormats()</a> - <a href=index.html>DragDrop Index</a> - <a href=dragtext.html>DragText()</a> ->

</body></html>